HAL CEC IRQ handler and callbacks functions migration

This section provides information about the HAL CEC callback functions migration.

HAL CEC callbacks functions

Title

HAL1

HAL2

TX complete Callback

void HAL_CEC_TxCpltCallback(CEC_HandleTypeDef *hcec);
void HAL_CEC_TxCpltCallback(hal_cec_handle_t *hcec);

RX complete Callback

void HAL_CEC_RxCpltCallback(CEC_HandleTypeDef *hcec,
                            pCEC_RxCallbackTypeDef pCallback);
void HAL_CEC_RxCpltCallback(hal_cec_handle_t *hcec);

CEC error Callback

void HAL_CEC_ErrorCallback(CEC_HandleTypeDef *hcec);
void HAL_CEC_ErrorCallback(hal_cec_handle_t *hcec);

HAL CEC register callback functions

In HAL1, the function HAL_CEC_RegisterCallback() is used to register various CEC callbacks through a single function with a specific callback ID. In HAL2, distinct functions are available to register each specific CEC callback.

Function

HAL1

HAL2

Tx Complete Callback

HAL_CEC_RegisterCallback(&hcec,
                  HAL_CEC_TX_CPLT_CB_ID,
                  USER_CEC_TxCpltCallback);
HAL_CEC_RegisterTxCpltCallback(&hcec,
                      USER_CEC_TxCpltCallback);

Rx Complete Callback

HAL_CEC_RegisterRxCpltCallback(hcec,
                  USER_CEC_RxCpltCallback);
HAL_CEC_RegisterRxCpltCallback(&hcec,
                     USER_CEC_RxCpltCallback);

CEC Error Callback

HAL_CEC_RegisterCallback(&hcec,
                  HAL_CEC_ERROR_CB_ID,
                  USER_CEC_ErrorCallback);
HAL_CEC_RegisterErrorCallback(&hcec,
                     USER_CEC_ErrorCallback);

CEC Msp Init Callback

HAL_CEC_RegisterCallback(&hcec,
                  HAL_CEC_MSPINIT_CB_ID,
                  USER_CEC_MspInitCallback);

Removed / Sequence changed

CEC Msp DeInit Callback

HAL_CEC_RegisterCallback(&hcec,
                  HAL_CEC_MSPDEINIT_CB_ID,
                  USER_CEC_MspDeInitCallback);

Removed / Sequence changed

Related concept:


HAL CEC unregister callback functions

In HAL1, the function HAL_CEC_UnRegisterCallback() is used with a callback ID. In HAL2, distinct functions are available to unregister each specific callback.

Function

HAL1

HAL2

Tx Complete Callback

HAL_CEC_UnRegisterCallback(&hcec,
                  HAL_CEC_TX_CPLT_CB_ID);
Removed; use HAL_CEC_RegisterTxCpltCallback(&hcec,
              HAL_CEC_TxCpltCallback) instead.

Rx Complete Callback

HAL_CEC_UnRegisterRxCpltCallback(&hcec);
Removed; use HAL_CEC_RegisterRxCpltCallback(&hcec,
              HAL_CEC_RxCpltCallback) instead.

CEC Error Callback

HAL_CEC_UnRegisterCallback(&hcec,
                  HAL_CEC_ERROR_CB_ID);
Removed; use HAL_CEC_RegisterErrorCallback(&hcec,
              HAL_CEC_ErrorCallback) instead.

CEC Msp Init Callback

HAL_CEC_UnRegisterCallback(&hcec,
                  HAL_CEC_MSPINIT_CB_ID);

Removed / Sequence changed

CEC Msp DeInit Callback

HAL_CEC_UnRegisterCallback(&hcec,
                  HAL_CEC_MSPDEINIT_CB_ID);

Removed / Sequence changed

Related concept:


HAL CEC IRQ Handler

HAL1

HAL2

HAL_CEC_IRQHandler(CEC_HandleTypeDef *hcec)
HAL_CEC_IRQHandler(hal_cec_handle_t *hcec)

Related concept: